.TH gnap_make 1 "April 2005" "GNAP"
.SH NAME
gnap_make \- Build a GNAP core from scratch
.SH SYNOPSIS
.B gnap_make
[options]
.SH DESCRIPTION
.B gnap_make
will produce a new GNAP core. It will start from a specs directory and stage
seed file, proceed through the [snapshot], [stage3], [livecd-stage1],
[livecd-stage2] and [tarball] stages to produce a GNAP core tarball.
.SH OPTIONS
.TP
.B "\-t" stagename
Execute the specified stage. Valid values are:
.B snapshot stage3 livecd-stage1 livecd-stage2 tarball
and the special
.B all
target.
At least one
.B "\-t"
option must be provided. If the
.B all
target is specified, gnap_make will execute all stages, bypassing
the [snapshot] stage if a
.B "\-p"
option was provided.
.TP
.B "\-p" snapshot_stamp
Timestamp of the portage snapshot file to use in the build.
Default value is the current date.
.TP
.B "\-o" portage_overlay
Location of a portage overlay to use. Default is not using any portage overlay.
.TP
.B "\-v" version_stamp 
Timestamp for the GNAP build. Useful to continue from previously built stages.
By default, GNAP builds will use the same timestamp as the Portage snapshot.
.TP
.B "\-f"
Force all answers to yes, and append to any existing log files.
Use at your own risk.
.TP
.B "\-s" seedstagefile
File to use as a stage2.tar.bz2 seed stage. A valid stage2 seed tarball must
be provided if the stage3 target must be built.
By default, gnap_make will look for the /usr/lib/gnap/stage2seed.tar.bz2 file.
.TP
.B "\-l" logfile
Location of the logfile. 
By default, it will use a local ./gnap_make-YYYYMMDD.log file.
.TP
.B "\-c" catalyst.conf
Location of the catalyst.conf file to use as catalyst configuration.
By default, it will use the /etc/catalyst/catalyst.conf file.
.TP
.B "\-e" specs_dir
Full path to the location of the spec files directory.
By default it will use the /usr/lib/gnap/specs directory.
.SH EXAMPLES
.B gnap_make
-t all

Do a complete GNAP build.

.B gnap_make
-p 20041020 -v 20041105 -t livecd-stage1 -t livecd-stage2

Build a livecd iso, starting from an already built stage3-20041105 tarball,
using an existing 20041020 Portage snapshot.
.SH FILES
.P 
.I common.conf
Spec file containing common options for GNAP.
.SH SEE ALSO
.BR catalyst (1), 
.BR gnap_overlay (1)
.SH AUTHOR
.nf
Thierry Carrez (koon@gentoo.org)
.fi
